package com.app.brilliant.game.service;
import com.app.brilliant.common.service.BaseService;
import com.app.brilliant.game.bean.BriUserHourComplete;
import com.app.brilliant.game.response.BriCourseCompleteInfo;
import java.time.LocalDate;
import java.util.List;
/**
* @author GF
* @description 针对表【bri_user_hour_complete】的数据库操作Service
* @createDate 2025-09-02 17:16:39
*/
public interface BriUserHourCompleteService extends BaseService<BriUserHourComplete> {
    /**
     * 完成课时学习
     * @param classHourId 课时ID
     * @param userId 用户ID
     * @return 操作结果
     */
    boolean completeClassHour(Integer classHourId, Integer userId);
    
    /**
     * 查询用户指定课程下的课时完成度信息
     * @param courseId 课程ID
     * @param userId 用户ID
     * @return 课时完成度信息列表
     */
    List<BriCourseCompleteInfo> getCourseCompleteInfo(Integer courseId, Integer userId);

    boolean hasCompletionRecordOnDate(LocalDate date, Integer userId);

    /**
     * 根据用户ID和课时ID查询课时完成记录
     * @param userId 用户ID
     * @param classHourId 课时ID
     * @return 课时完成记录
     */
    BriUserHourComplete getByUserIdAndClassHourId(Integer userId, Integer classHourId);
}
